Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[KYUUBI #1269] Online documentation section in the readme is outdated #1270

Closed
wants to merge 3 commits into from

Conversation

ulysses-you
Copy link
Contributor

Why are the changes needed?

Closes #1269

How was this patch tested?

docs only

README.md Outdated
- [v1.0.2](https://kyuubi.readthedocs.io/en/v1.0.2/)
- [v1.0.1](https://kyuubi.readthedocs.io/en/v1.0.1/)
- [v1.0.0](https://kyuubi.readthedocs.io/en/v1.0.0/)
- [master/latest](https://kyuubi.apache.org/docs/latest/)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not correct, the https://kyuubi.apache.org/docs/latest/ point to the latest released doc. cc @turboFei for double confirm

README.md Outdated
@@ -96,19 +96,15 @@ The figure below shows our vision for the Kyuubi Ecosystem. Some of them have be
Since Kyuubi 1.0.0, the Kyuubi online documentation is hosted by [https://readthedocs.org/](https://readthedocs.org/).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add since 1.3.0-incubating ...

@cfmcgrady
Copy link
Contributor

It seems we need to update the following links as well.

 [pr-1270] >grep readthedocs * -R                                                              
README.md:[![Documentation Status](https://readthedocs.org/projects/kyuubi/badge/?version=latest)](https://kyuubi.apache.org/?badge=latest)
README.md:Since Kyuubi 1.0.0, the Kyuubi online documentation is hosted by [https://readthedocs.org/](https://readthedocs.org/).
README.md:- Improve Documentation - [![Documentation Status](https://readthedocs.org/projects/kyuubi/badge/?version=latest)](https://kyuubi.readthedocs.io/en/latest/?badge=latest)
conf/kyuubi-defaults.conf.template:# Details in https://kyuubi.readthedocs.io/en/latest/deployment/settings.html
docs/deployment/settings.md:# Details in https://kyuubi.readthedocs.io/en/latest/deployment/settings.html
Binary file docs/_build/doctrees/deployment/settings.doctree matches
Binary file docs/_build/doctrees/community/contributions.doctree matches
Binary file docs/_build/doctrees/quick_start/quick_start_with_datagrip.doctree matches
docs/community/contributions.md:     https://kyuubi.readthedocs.io/en/latest/community/contributions.html
docs/community/contributions.md:- [ ] [Run test](https://kyuubi.readthedocs.io/en/latest/develop_tools/testing.html#running-tests) locally before make a pull request
docs/quick_start/quick_start_with_helm.md:[Using Hive Beeline](https://kyuubi.readthedocs.io/en/latest/quick_start/quick_start.html#using-hive-beeline) to opening a connection.
docs/quick_start/quick_start_with_datagrip.md:[Get kyuubi server started](https://kyuubi.readthedocs.io/en/latest/quick_start/quick_start.html) before you try DataGrip with kyuubi.

@ulysses-you ulysses-you marked this pull request as draft October 21, 2021 09:00
@codecov-commenter
Copy link

codecov-commenter commented Oct 22, 2021

Codecov Report

Merging #1270 (1cb99ef) into master (f0f065b) will decrease coverage by 0.06%.
The diff coverage is n/a.

Impacted file tree graph

@@             Coverage Diff              @@
##             master    #1270      +/-   ##
============================================
- Coverage     78.30%   78.24%   -0.07%     
  Complexity      110      110              
============================================
  Files           176      177       +1     
  Lines          6886     6940      +54     
  Branches        843      852       +9     
============================================
+ Hits           5392     5430      +38     
- Misses         1037     1042       +5     
- Partials        457      468      +11     
Impacted Files Coverage Δ
...che/kyuubi/ha/client/ZooKeeperClientProvider.scala 70.17% <0.00%> (-11.88%) ⬇️
...ache/kyuubi/engine/spark/SparkProcessBuilder.scala 86.86% <0.00%> (-2.91%) ⬇️
...n/scala/org/apache/kyuubi/engine/ProcBuilder.scala 89.89% <0.00%> (-1.02%) ⬇️
...apache/kyuubi/ha/client/ZooKeeperACLProvider.scala 85.00% <0.00%> (-0.72%) ⬇️
...in/scala/org/apache/kyuubi/config/KyuubiConf.scala 95.22% <0.00%> (-0.02%) ⬇️
...g/apache/kyuubi/ha/client/ZooKeeperAuthTypes.scala 100.00% <0.00%> (ø)
...la/org/apache/kyuubi/ha/HighAvailabilityConf.scala 98.85% <0.00%> (+0.32%) ⬆️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f0f065b...1cb99ef. Read the comment docs.

@ulysses-you ulysses-you marked this pull request as ready for review October 22, 2021 04:43
@ulysses-you
Copy link
Contributor Author

thank you @pan3793 @cfmcgrady for the review, addressed comment.

@ulysses-you
Copy link
Contributor Author

aslo cc @aajisaka @yaooqinn @turboFei if you have time to take a look

Copy link
Member

@aajisaka aajisaka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks @ulysses-you

@ulysses-you
Copy link
Contributor Author

thank you all for the reivew ! merging to master/branch-1.3

ulysses-you added a commit that referenced this pull request Oct 22, 2021
<!--
Thanks for sending a pull request!

Here are some tips for you:
  1. If this is your first time, please read our contributor guidelines: https://kyuubi.readthedocs.io/en/latest/community/contributions.html
  2. If the PR is related to an issue in https://github.com/apache/incubator-kyuubi/issues, add '[KYUUBI #XXXX]' in your PR title, e.g., '[KYUUBI #XXXX] Your PR title ...'.
  3. If the PR is unfinished, add '[WIP]' in your PR title, e.g., '[WIP][KYUUBI #XXXX] Your PR title ...'.
-->

<!--
Please clarify why the changes are needed. For instance,
  1. If you add a feature, you can talk about the use case of it.
  2. If you fix a bug, you can clarify why it is a bug.
-->
Closes #1269

docs only

Closes #1270 from ulysses-you/kyuubi#1269.

Closes #1269

1cb99ef [ulysses-you] address comment
7a597e6 [ulysses-you] address comment
4b15c2c [ulysses-you] Online documentation section in the readme is outdated

Authored-by: ulysses-you <[email protected]>
Signed-off-by: ulysses-you <[email protected]>
(cherry picked from commit 936a532)
Signed-off-by: ulysses-you <[email protected]>
@ulysses-you ulysses-you deleted the kyuubi#1269 branch October 22, 2021 06:24
@ulysses-you ulysses-you added this to the v1.3.2 milestone Oct 22, 2021
@ulysses-you ulysses-you self-assigned this Oct 22, 2021
@@ -79,6 +79,6 @@ Please clarify why the changes are needed. For instance,

- [ ] Add screenshots for manual tests if appropriate

- [ ] [Run test](https://kyuubi.readthedocs.io/en/latest/develop_tools/testing.html#running-tests) locally before make a pull request
- [ ] [Run test](https://kyuubi.apache.org/docs/latest/develop_tools/testing.html#running-tests) locally before make a pull request
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this PR template is also outdated

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[Bug] Online documentation section in the readme is outdated
6 participants